Samples

Net2Phone Canada provides access to a great deal of communication data through our REST resources. You will find a subset of these resources outlined below. A full list of available resources can be found on our API Documentation page. Please ensure you understand how to obtain an Access Token by reading about Authentication before proceeding.

Call History

Call Data Records (CDRs) 

Get Call Data Records for one or more users in your domain. These Records contain details about phone calls which occured in your domain.

Description Collection CDR data for your entire company
Method: GET
API Documentation: Domain CDRs
URL: https://integrate.versature.com/api/cdrs/users/
Request: 
curl -X GET
-H 'Accept:application/vnd.integrate.v1.6.0+json'
-H 'Authorization: Bearer abce14243asdf823kk32323'
https://integrate.versature.com/api/cdrs/useres/?start_date=2017-2-1&end_date=2017-3-1
                                                

                                                versature.cdrs(start_date='2017-09-01:12:45:00', end_date='2017-10-24:00:00:00')
Response: 
HTTP/1.1 200 OK
{
    "cursor": "asdfasdfasdfasdf#asdfasdfs==",
    "more" : true,
    "result": [
        {
            "to": {
                "call_id": "2350150304190117063148-7ac5d753bddb15fb2f5900018ca04s746",
                "domain": "cc.example.com",
                "id": null,
                "user": "101"
                },
            "from": {
                "call_id": "20150304190127063799-a5ce697165aca204d39dde1a4446c1a0",
                "domain": "cc.example.com",
                "name": "John Smith",
                "id": null,
                "user": "100"
                },
            "answer_time": Fri, 03 Mar 2017 18:47:50 +0000,
            "start_time": Fri, 03 Mar 2017 18:47:39 +0000,
            "end_time": Fri, 03 Mar 2017 18:48:26 +0000,
            "duration": 20
            },
            {"to": {
                "call_id": "50150304190117063148-7ac5d753bddb15fb2f5900018ca04sdfd",
                "domain": null,
                "id": "+16132379329",
                "user": null
                },
            "from":
                {"call_id": "20150304190117063148-7ac5d753bddb15fb2f5900018ca06e24",
                "domain": "cc.example.com",
                "name": "Jane Doe",
                "id": null,
                "user": "100"
                },
            "start_time": "2015-03-04 19:01:17",
            "end_time": "2015-03-04 19:01:17",
            "duration": 10
        }
    ]
}

{
    "cursor": u"asdfasdfasdfasdf#asdfasdfs==",
    "more" : True,
    "result": [
        {
            u 'end_time': u '2018-03-02T23:44:34+00:00',
            u 'start_time': u '2018-03-02T23:44:27+00:00',
            u 'answer_time': None,
            u 'duration': 0,
            u 'to': {
                u 'domain': None,
                u 'call_id': u '20180302234427021761-508a49ea1a0a17f284f0f0f66fa5fcd2',
                u 'user': None,
                u 'id': u '+15748177931'
            },
            u 'from': {
                u 'name': u 'Anjel Valentino',
                u 'domain': u 'versature.com',
                u 'call_id': u 'a57ca9f734294d2085e543dc248b9f37',
                u 'id': u '+16132379329',
                u 'user': u '118'
            }
        }
    ]
}
Description Collection CDR data for a specific user
Method: GET
API Documentation: User CDRs
URL: https://integrate.versature.com/api/cdrs/users/{user}/
Request: 
curl -X GET
    -H 'Accept:application/vnd.integrate.v1.6.0+json'
    -H 'Authorization: Bearer abce14243asdf823kk32323'
    https://integrate.versature.com/api/cdrs/users/100/?start_date=2017-2-1&end_date=2017-3-1

                                                 versature.cdrs(user=151, start_date='2018-01-01:12:45:00', end_date='2018-03-03:00:00:00')
Response: 
HTTP/1.1 200 OK
{
    "cursor": "asdfasdfasdfasdf#asdfasdfs==",
    "more" : true,
    "result": [
        {
            "to": {
                "call_id": "2350150304190117063148-7ac5d753bddb15fb2f5900018ca04s746",
                "domain": "cc.example.com",
                "id": null,
                "user": "100"
                },
            "from": {
                "call_id": "20150304190127063799-a5ce697165aca204d39dde1a4446c1a0",
                "domain": "cc.example.com",
                "name": "John Smith",
                "id": null,
                "user": "100"
                },
            "answer_time": Fri, 03 Mar 2017 18:47:50 +0000,
            "start_time": Fri, 03 Mar 2017 18:47:39 +0000,
            "end_time": Fri, 03 Mar 2017 18:48:26 +0000,
            "duration": 20
            },
            {"to": {
                "call_id": "50150304190117063148-7ac5d753bddb15fb2f5900018ca04sdfd",
                "domain": null,
                "id": "+16132379329",
                "user": null
                },
            "from":
                {"call_id": "20150304190117063148-7ac5d753bddb15fb2f5900018ca06e24",
                "domain": "cc.example.com",
                "name": "Jane Doe",
                "id": null,
                "user": "100"
                },
            "start_time": "2015-03-04 19:01:17",
            "end_time": "2015-03-04 19:01:17",
            "duration": 10
        }
    ]
}

{
    "cursor": u"asdfasdfasdfasdf#asdfasdfs==",
    "more" : True,
    "result": [
        {
            u 'to': {
                u 'user': None,
                u 'id': u '+1814841814',
                u 'domain': None,
                u 'call_id': u '20180215205527061123-508a49ea1a0a17f284f0f0f66fa5fcd2'
            },
            u 'start_time': u '2018-02-15T20:55:25+00:00',
            u 'end_time': u '2018-02-15T20:55:28+00:00',
            u 'duration': 2,
            u 'answer_time': None,
            u 'from': {
                u 'user': u '151',
                u 'call_id': u '4f8005b4d663d7f580d7233787ea9bc5',
                u 'id': None,
                u 'domain': u 'versature.com',
                u 'name': u 'Jon Dos'
            }
            }, {
            u 'to': {
                u 'user': u '151',
                u 'id': None,
                u 'domain': u 'versature.com',
                u 'call_id': u '20180103160226000366-508a49ea1a0a17f284f0f0f66fa5fcd2'
            },
            u 'start_time': u '2018-01-03T16:02:26+00:00',
            u 'end_time': u '2018-01-03T16:02:44+00:00',
            u 'duration': 8,
            u 'answer_time': u '2018-01-03T16:02:36+00:00',
            u 'from': {
                u 'user': u '194',
                u 'call_id': u '898b44e01e89fa62742089464db10d20',
                u 'id': None,
                u 'domain': u 'versature.com',
                u 'name': u 'Versature Lounge'
            }
        }
    ]
}
Users

User Details 

Get information such as name, access level, time zone for the users in your domain.

Description Collection user data for all users in a domain
Method: GET
API Documentation: Users
URL: https://integrate.versature.com/api/users/
Request: 
curl -X GET
-H 'Accept:application/vnd.integrate.v1.4.0+json'
-H 'Authorization: Bearer abce14243asdf823kk32323'
https://integrate.versature.com/api/users/
                                             

                                                 versature.users()
Response: 
HTTP/1.1 200 OK
[
    {
    "username": "110@example.com",
    "user": "100",
    "domain": "example.com",
    "last_name": "Smith",
    "first_name": "John",
    "email": "noreply@example.com",
    "time_zone": "Canada/Eastern",
    "scope": "Office Manager"
    }
]
[{
    u 'last_name': u 'Eser',
    u 'user': u '104',
    u 'domain': u 'versature.com',
    u 'scope': u 'Office Manager',
    u 'username': u '104@example.com',
    u 'email': u 'versature.com@vm2txt.net',
    u 'first_name': u 'Peter',
    u 'time_zone': u 'Canada/Eastern'
}, {
    u 'last_name': u 'Desmond',
    u 'user': u '106',
    u 'domain': u 'versature.com',
    u 'scope': u 'Basic User',
    u 'username': u '106@example.com',
    u 'email': u 'sips@example.com',
    u 'first_name': u 'Sid',
    u 'time_zone': u 'Canada/Eastern'
}, {
    u 'last_name': u 'Phils',
    u 'user': u '109',
    u 'domain': u 'versature.com',
    u 'scope': u 'Super User',
    u 'username': u '109@example.com',
    u 'email': u 'liipsips@example.com',
    u 'first_name': u 'Susan',
    u 'time_zone': u 'Canada/Eastern'
}]
Description Collection CDR data for a specific user
Method: GET
API Documentation: User
URL: https://integrate.versature.com/api/users/{user}/
Request: 
curl -X GET
-H 'Accept:application/vnd.integrate.v1.4.0+json'
-H 'Authorization: Bearer abce14243asdf823kk32323'
https://integrate.versature.com/api/users/100/
                                                

                                                 versature.users(user='151')
Response: 
HTTP/1.1 200 OK
{
    "username": "110@example.com",
    "user": "100",
    "domain": "example.com",
    "last_name": "Smith",
    "first_name": "John",
    "email": "noreply@example.com",
    "time_zone": "Canada/Eastern",
    "scope": "Office Manager"
}


[
    {
        u 'time_zone': u 'Canada/Eastern',
        u 'user': u '151',
        u 'scope': u 'Office Manager',
        u 'first_name': u 'Ihtisham',
        u 'last_name': u 'Mazhar',
        u 'email': u 'imazsature.com@vm2txt.net',
        u 'username': u '151@example.com',
        u 'domain': u 'versature.com'
    }
]
Description Collection CDR data for the authenticated user
Method: GET
API Documentation: Current User
URL: https://integrate.versature.com/api/cdrs/users/current/
Request: 
curl -X GET
    -H 'Accept:application/vnd.integrate.v1.4.0+json'
    -H 'Authorization: Bearer abce14243asdf823kk32323'
    https://integrate.versature.com/api/users/current/

                                                versature.current_user()
Response: 
HTTP/1.1 200 OK
{
    "username": "110@example.com",
    "user": "100",
    "domain": "example.com",
    "last_name": "Smith",
    "first_name": "John",
    "email": "noreply@example.com",
    "time_zone": "Canada/Eastern",
    "scope": "Office Manager"
}

{
    u 'time_zone': u 'Canada/Eastern',
    u 'domain': u 'versature.com',
    u 'last_name': u 'Mazhar',
    u 'scope': u 'Office Manager',
    u 'user': u '100',
    u 'first_name': u 'John',
    u 'last_name': u 'Smith',
    u 'username': u '100@example.com',
    u 'email': u 'noreply@example.com'
}
Phone Calls

Calls 

Place, terminate, list and generally manage your phone calls programmatically through the calls endpoint.

Description Programmatically place a phone call for the authenticated user.
Method: POST
API Documentation: Place a Call
URL: https://integrate.versature.com/api/calls/
Request: 
curl -X POST
-H 'Accept:application/vnd.integrate.v1.4.0+json'
-H 'Authorization: Bearer abce14243asdf823kk32323'
https://integrate.versature.com/api/calls/
-d $'{"to": "6132379329"}'
                                            

                                                versature.place_call(to='126')
Response: 
HTTP/1.1 201 OK

{}
Description List Active calls for your domain
Method: GET
API Documentation: Domain Active Calls
URL: https://integrate.versature.com/api/users/active/
Request: 
curl -X GET
-H 'Accept:application/vnd.integrate.v1.4.0+json'
-H 'Authorization: Bearer abce14243asdf823kk32323'
https://integrate.versature.com/api/users/active/

                                                 versature.active_calls()
Response: 
HTTP/1.1 200 OK
[{
    "calls": {
        "on_net": false,
        "from": {
            "user": null,
            "name": "Terry Henry",
            "domain": null,
            "id": "+16133246100",
            "call_id": "e351b3325aa18832e3aa36948d012424"
        },
        "to": {
            "id": "+16132231329",
            "domain": "versature.com",
            "user": "126",
            "call_id": "abcdb3325aa18832e3aa36948d012424"
        },
        "time_answer": null,
        "time_start": "2016-11-24 15:53:12",
        "by_call_id": null
    }
}]

[{
   u'calls': {
       u'on_net': false,
       u'from': {u'user': None, u'name':u'David Ward', u'domain': None, u'id':u'+16133246100', u'call_id':u'e351b3325aa18832e3aa36948d012424'},
       u'to': {u'id':u'+16131111329', u'domain':u'versature.com', u'user':u'126', u'call_id':u'abcdb3325aa18832e3aa36948d012424'},
       u'time_answer': None,
       u'time_start':u'2017-11-24 15:53:12',
       u'by_call_id': None
   }
}]
SIP Devices

Devices 

Obtain a list of devices for a specific user or across your domain.

Description Obtain a list of devices for your company
Method: GET
API Documentation: Domain Devices
URL: https://integrate.versature.com/api/devices/users/
Request: 
curl -X GET
-H 'Accept:application/vnd.integrate.v1.4.0+json'
-H 'Authorization: Bearer abce14243asdf823kk32323'
https://integrate.versature.com/api/devices/users/
                                            

                                                versature.devices()
Response: 
HTTP/1.1 200 OK
[{
    "device": "sip:100@example.com",
    "mac": "1004c84c49ca",
    "model": "Polycom 550",
    "registration_time": "2017-05-23T14:09:59+00:00"
},
    {
    "device": "sip:129@example.com",
    "mac": "1004c84c41441a",
    "model": "Polycom VVX",
    "registration_time": "2017-12-23T14:59:59+00:00"
},
    {
    "device": "sip:151@example.com",
    "mac": "1004c84c41441a",
    "model": "Polycom VVX",
    "registration_time": "2017-12-23T14:59:59+00:00"
}]
                                        
[{
  u 'device': u 'sip:116@example.com',
  u 'registration_time': u '2018-03-22T14:12:37+00:00',
  u 'mac': u '0004f28c2abe',
  u 'model': u 'Polycom VVX410x'
}, {
  u 'device': u 'sip:130@example.com',
  u 'registration_time': u '2018-03-22T14:11:38+00:00',
  u 'mac': u '0004f2b10d1c',
  u 'model': u 'Polycom VVX500x'
}, {
  u 'device': u 'sip:132@example.com',
  u 'registration_time': u '2018-03-22T14:11:36+00:00',
  u 'mac': u '64167f012422',
  u 'model': u 'Polycom VVX401x'
}, {
  u 'device': u 'sip:125t@example.com',
  u 'registration_time': u '2018-03-22T14:11:26+00:00',
  u 'mac': u '080023d4373b',
  u 'model': u 'Panasonic KX-TGP600C'
}, {
  u 'device': u 'sip:8400.versature.com@conference-bridge',
  u 'registration_time': u '2018-03-22T14:11:12+00:00',
  u 'mac': None,
  u 'model': None
}]
Description Obtain a list of devices for a user
Method: GET
API Documentation: User Devices
URL: https://integrate.versature.com/api/devices/users/{user}/
Request: 
curl -X GET
-H 'Accept:application/vnd.integrate.v1.4.0+json'
-H 'Authorization: Bearer abce14243asdf823kk32323'
https://integrate.versature.com/api/devices/users/100/
                                            

                                                versature.devices(user='132')
Response: 
HTTP/1.1 200 OK
[{
  "device": "sip:100@example.com",
  "mac": "1004c84c49ca",
  "model": "Polycom 550",
  "registration_time": "2017-05-23T14:09:59+00:00"
}]
                                        

{
  u 'device': u 'sip:132@example.com',
  u 'registration_time': u '2018-03-22T14:11:36+00:00',
  u 'mac': u '64167f012422',
  u 'model': u 'Polycom VVX401x'
}
Queues and Agents

Call Queues 

Obtain information and statistics about your call queues, or agents in queues.

Description Get a list of all the call queues in your domain.
Method: GET
API Documentation: Call Queues
URL: https://integrate.versature.com/api/call_queues/{queue}/
Request: 
curl -X GET
-H 'Accept:application/vnd.integrate.v1.4.0+json'
-H 'Authorization: Bearer abce14243asdf823kk32323'
https://integrate.versature.com/api/call_queues/
                                            
versature.call_queues()
Response: 
[{
  "agent_count":17,
  "queue":"8846",
  "description":"Billing Queue",
  "agent_available_count":4
},
{
  "agent_count":1,
  "queue":"8813",
  "description":"Callback Test Queue",
  "agent_available_count":1
},
{
  "agent_count":4,
  "queue":"8833",
  "description":"NOC",
  "agent_available_count":1
}]
        

[
    {
        u 'queue': u '835',
        u 'description': u 'Billing Queue',
        u 'agent_count': 17,
        u 'agent_available_count': 5
    },{
        u 'queue': u '814',
        u 'description': u 'Example Support',
        u 'agent_count': 14,
        u 'agent_available_count': 3
    }, {
        u 'queue': u '885',
        u 'description': u 'Example Support 2',
        u 'agent_count': 28,
        u 'agent_available_count': 10
    }
]
Description Get a list of agents in your call queues.
Method: GET
API Documentation: Call Queue Agents
URL: https://integrate.versature.com/api/call_queues/{queue}/agents/stats/
Request: 
curl -X GET
-H 'Accept:application/vnd.integrate.v1.4.0+json'
-H 'Authorization: Bearer abce14243asdf823kk32323'
https://integrate.versature.com/api/call_queues/agents/stats/?start_date=2017-04-1&end_date=2017-05-02T03:24:00
                                            
versature.call_queue_agents(queue='8815')
Response: 

[
    {
        "status":"available",
        "first_name":"Frank",
        "last_name":"Charlebois",
        "last_update":"2018-01-08T15:56:47+00:00",
        "user":"125",
        "device":"sip:125@example.com"
    }
]

[
    {
        u 'last_update': u '2018-03-22T14:30:49+00:00',
        u 'device': u 'sip:112@example.com',
        u 'first_name': u 'Andeese',
        u 'user': u '112',
        u 'last_name': u 'Pele',
        u 'status': u 'available'
    }, {
        u 'last_update': u '2018-03-16T07:31:00+00:00',
        u 'device': u 'sip:112c@example.com',
        u 'first_name': u 'Jack',
        u 'user': u '112c',
        u 'last_name': u 'Nick',
        u 'status': u 'unavailable'
    }, {
        u 'last_update': u '2018-03-19T20:11:58+00:00',
        u 'device': u 'sip:112h@example.com',
        u 'first_name': u 'Koleae',
        u 'user': u '112h',
        u 'last_name': u 'faele',
        u 'status': u 'unavailable'
    }
]
Description Request statistical data for call queues in your domain.
Method: GET
API Documentation: Call Queue Statistics
URL: https://integrate.versature.com/api/call_queues/{queue}/stats/
Request: 
curl -X GET
-H 'Accept:application/vnd.integrate.v1.4.0+json'
-H 'Authorization: Bearer abce14243asdf823kk32323'
https://integrate.versature.com/api/call_queues/stats/8814/?start_date=2017-05-01T24:00:00&end_date=2017-06-01T24:00:00
                                            
versature.call_queue_stats(start_date='2017-05-01T24:00:00',end_date='2017-05-01T24:00:00')
Response: 

[{
    "dial_transfers": 0.0,
    "average_answer_speed": 0,
    "service_level": 100.0,
    "adjusted_abandoned_rate": 0.0,
    "calls_to_voicemail": 0,
    "calls_offered": 3,
    "average_hold_time": 6,
    "average_handle_time": 78,
    "abandoned_rate": 0.0,
    "queue": "8800",
    "adjusted_calls_offered": 3,
    "calls_handled": 3,
    "call_volume": 0,
    "average_talk_time": 72,
    "abandoned_calls": 0,
    "adjusted_abandoned_calls": 0,
    "calls_forwarded": 0
}]
        

 
[
     {
        u 'calls_to_voicemail': 0,
        u 'average_answer_speed': 0,
        u 'average_handle_time': 0,
        u 'calls_offered': 0,
        u 'service_level': u '0.0',
        u 'abandoned_rate': u '0.0',
        u 'average_talk_time': 0,
        u 'call_volume': 0,
        u 'abandoned_calls': 0,
        u 'calls_forwarded': 0,
        u 'dial_transfers': u '0.0',
        u 'adjusted_abandoned_calls': 0,
        u 'adjusted_calls_offered': 0,
        u 'average_hold_time': 0,
        u 'queue': u '8825',
        u 'calls_handled': 0,
        u 'adjusted_abandoned_rate': u '0.0'
    }, {
        u 'calls_to_voicemail': 0,
        u 'average_answer_speed': 0,
        u 'average_handle_time': 0,
        u 'calls_offered': 0,
        u 'service_level': u '0.0',
        u 'abandoned_rate': u '0.0',
        u 'average_talk_time': 0,
        u 'call_volume': 0,
        u 'abandoned_calls': 0,
        u 'calls_forwarded': 0,
        u 'dial_transfers': u '0.0',
        u 'adjusted_abandoned_calls': 0,
        u 'adjusted_calls_offered': 0,
        u 'average_hold_time': 0,
        u 'queue': u '8900',
        u 'calls_handled': 0,
        u 'adjusted_abandoned_rate': u '0.0'
    }, {
        u 'calls_to_voicemail': 0,
        u 'average_answer_speed': 0,
        u 'average_handle_time': 0,
        u 'calls_offered': 0,
        u 'service_level': u '0.0',
        u 'abandoned_rate': u '0.0',
        u 'average_talk_time': 0,
        u 'call_volume': 0,
        u 'abandoned_calls': 0,
        u 'calls_forwarded': 0,
        u 'dial_transfers': u '0.0',
        u 'adjusted_abandoned_calls': 0,
        u 'adjusted_calls_offered': 0,
        u 'average_hold_time': 0,
        u 'queue': u '8901',
        u 'calls_handled': 0,
        u 'adjusted_abandoned_rate': u '0.0'
     }
Call Queue Reports

Reports 

The Net2Phone Canada API can also generate comprehensive reports for your Company Call Data. See the API doc on how to generate more reports than the ones listed here.

Description A split report will tell you provide a call metrics at given intervals. These intervals can be hours, days or months.
Method: GET
API Documentation: Split Report
URL: https://integrate.versature.com/api/call_queues/{queue}/reports/splits/
Request: 
curl -X GET
-H 'Accept:application/vnd.integrate.v1.4.0+json'
-H 'Authorization: Bearer abce14243asdf823kk32323'
https://integrate.versature.com/api/call_queues/reports/splits/start_date=2017-05-23T12:00:00-00:00&end_date=2017-05-23T13:00:00-00:00&period=hour
versature.call_queue_split_report(queue='8813', start_date='2018-01-05', end_date='2017-01-31', period='hour')
Response: 

[
    {
        "volume": 3,
        "interval": "2017-05-23T12:00:00+00:00"
    },
    {
        "volume": 2,
        "interval": "2017-05-23T13:00:00+00:00"
    }
]
                                       
[{
    u 'interval': u '2018-03-01T13:00:00+00:00',
    u 'volume': 1
}, {
    u 'interval': u '2018-03-01T19:00:00+00:00',
    u 'volume': 1
}, {
    u 'interval': u '2018-03-01T20:00:00+00:00',
    u 'volume': 2
}]
Description A dialled number report will give you a breakdown of all the phone numbers which were dialled.
Method: GET
API Documentation: Dialled Number Report
URL: https://integrate.versature.com/api/call_queues/{queue}/reports/dialled_numbers/
Request: 
curl -X GET
-H 'Accept:application/vnd.integrate.v1.4.0+json'
-H 'Authorization: Bearer abce14243asdf823kk32323'
https://integrate.versature.com/api/call_queues/8814/reports/dialled_numbers/?start_date=2017-05-23T12:00:00-00:00&end_date=2017-05-23T12:59:59-00:00&period=hour
versature.call_queue_dialled_numbers_report(queue='8813', start_date='2018-01-05', end_date='2017-01-31', period='hour')
Response: 

[
    {
        "volume": 2,
        "dialled_number": "611",
        "interval": "2017-05-23T12:00:00+00:00"
    },{
        "volume": 1,
        "dialled_number": "+16132379329",
        "interval": "2017-05-23T12:00:00+00:00"
    }
]
                                        

[
    {
        u 'interval': u '2018-03-01T13:00:00+00:00',
        u 'volume': 1,
        u 'dialled_number': u '611'
    }, {
        u 'interval': u '2018-03-01T19:00:00+00:00',
        u 'volume': 1,
        u 'dialled_number': u '+16136272153'
    }, {
        u 'interval': u '2018-03-01T20:00:00+00:00',
        u 'volume': 2,
        u 'dialled_number': u '611'
    }
]
Voicemail Information

Voicemails 

Currently the Integrate API can provide a voicemail count breakdown for a given user in a domain.

Description Determine how many voicemails are new and saved on the system for a given user.
Method: GET
API Documentation: Voicemail Count
URL: https://integrate.versature.com/api/voicemails/users/151/count/
Request: 
curl -X GET
-H 'Accept:application/vnd.integrate.v1.4.0+json'
-H 'Authorization: Bearer abce14243asdf823kk32323'
https://integrate.versature.com/api/voicemails/users/:user/count/

versature.voicemail_count(user='151')
Response: 

{
    "new": 1,
    "saved": 2
}
                                       
{u'new': 0, u'saved': 0}